home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / ircombine.z / ircombine
Encoding:
Text File  |  2001-04-17  |  35.1 KB  |  595 lines
  1.  
  2.  
  3.  
  4. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ircombine - Create, modify, query, load and save video format
  10.      combinations
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ////uuuussssrrrr////ggggffffxxxx////iiiirrrrccccoooommmmbbbbiiiinnnneeee [destination] [source] [options]
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      iiiirrrrccccoooommmmbbbbiiiinnnneeee creates and operates on _v_i_d_e_o _f_o_r_m_a_t _c_o_m_b_i_n_a_t_i_o_n_s, descriptions
  18.      of raster sizes and timings to be used on video outputs, as well as the
  19.      configuration of the underlying frame buffer.  The resulting combination
  20.      can be used as the current video configuration, stored as the default
  21.      configuration to be used at system power-up or graphics initialization,
  22.      or saved in a video format combination file.  The combination can be
  23.      created from scratch or by modifying the current or a saved combination.
  24.      Ircombine requires write access to the /usr/gfx/ucode/KONA/dg4/cmb
  25.      directory to download combinations. Users can change between pre-built
  26.      combinations using the setmon(1g) command.  iiiirrrrccccoooommmmbbbbiiiinnnneeee subsumes the
  27.      functionality of sssseeeettttmmmmoooonnnn((((1111GGGG))))....
  28.  
  29.  
  30.    OOOOppppttttiiiioooonnnnssss
  31.      ----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn [aaaaccccttttiiiivvvveeee | eeeeeeeepppprrrroooommmm | ffffiiiilllleeee <_f_i_l_e_n_a_m_e>] - This option specifies
  32.      the destination of the video format combination.  If this option is
  33.      omitted, and no queries are specified, iiiirrrrccccoooommmmbbbbiiiinnnneeee will bring up a
  34.      graphical interface by default.
  35.  
  36.  
  37.           aaaaccccttttiiiivvvveeee specifies that the combination will be loaded as the current,
  38.           active video configuration, but not saved in the eeprom.  This will
  39.           temporarily change the video configuration, but the combination will
  40.           not be used when graphics is initialized or the the system is
  41.           powered up. A destination of active is only legal if the target
  42.           machine is local.
  43.  
  44.           eeeeeeeepppprrrroooommmm specifies that the combination will be saved in the eeprom
  45.           and used as the default.  The combination does not take effect
  46.           immediately; it is only used the next time graphics is initialized
  47.           or the system is powered up.  To initialize graphics, use
  48.           (/_u_s_r/_g_f_x/_s_t_o_p_g_f_x; /_u_s_r/_g_f_x/_s_t_a_r_t_g_f_x) &
  49.  
  50.           ffffiiiilllleeee specifies that the combination will be saved in a video format
  51.           combination file <_f_i_l_e_n_a_m_e>.  <_f_i_l_e_n_a_m_e> is specified relative to
  52.           the current working directory.
  53.  
  54.  
  55.      ----ssssoooouuuurrrrcccceeee [aaaaccccttttiiiivvvveeee | ffffiiiilllleeee <_f_i_l_e_n_a_m_e>] - This option controls the source of
  56.      the combination to me modified, loaded, or queried.  aaaaccccttttiiiivvvveeee and ffffiiiilllleeee are
  57.      similar to the options to ----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn.  If the source is aaaaccccttttiiiivvvveeee, the
  58.      destination must be aaaaccccttttiiiivvvveeee as well, and only the following parameters may
  59.      be modified: cursorpriority, filtersize, gain, gamma, hphase, pedestal,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  71.  
  72.  
  73.  
  74.      schphase, sourceloc, sourcesize, vphase; in addition, if the source is
  75.      aaaaccccttttiiiivvvveeee channels may be disabled, but not enabled.  If -source is not
  76.      specified, all parameters which are not specified take on their default
  77.      values.
  78.  
  79.  
  80.      ----gggguuuuiiii - Brings up a graphical interface with which to create video format
  81.      combinations.  If this option is specified in conjunction with other
  82.      options which modify the combination, the other operations are performed
  83.      first, and the gui may be used to make additional modifications.  This
  84.      option may not be specified with ----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn.  If no destination is
  85.      specified, and no queries are made to the combination, the graphical
  86.      interface is used by default.
  87.  
  88.      The following options modify the specified video format combination, or
  89.      query parameters of the combination and return them on stdout.
  90.  
  91.      ----gggglllloooobbbbaaaallll [[[[ppppaaaarrrraaaammmmeeeetttteeeerrrr||||ppppaaaarrrraaaammmmeeeetttteeeerrrr====vvvvaaaalllluuuueeee,,,,............]]]]  - Modifies or queries the global
  92.      attributes of the video format combination.  This option is followed by a
  93.      list of parameters or parameter assignments.  If no assignment is made,
  94.      the current setting of the parameter in the modified combination is
  95.      queried and returned on stdout.  Parameters may be specified multiple
  96.      times in order to both set and query a parameter.  Since commas delimit
  97.      parameters in this list, they not used in _v_a_l_u_e.  The following
  98.      parameters may be specified:
  99.  
  100.  
  101.           ggggaaaammmmmmmmaaaa====<_v_a_l_u_e> - Specifies the global output video gamma value for
  102.           this combination.  If the gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa parameter is OOOONNNN, this gamma
  103.           value is used for all channels in the combination.  Valid values for
  104.           gamma are floating point numbers in the range [0,20], and the
  105.           default is 1.7.  Setting this parameter modifies the gamma values on
  106.           all components of the output.  To modify the gamma value of a single
  107.           component, use one of the options ggggaaaammmmmmmmaaaarrrr, ggggaaaammmmmmmmaaaagggg, or ggggaaaammmmmmmmaaaabbbb.
  108.  
  109.           gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether the global gamma value is
  110.           used as the output video gamma for all channels in the combination.
  111.           The DG4-2 display generator supports a single output gamma map, so
  112.           gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa must be used with this target hardware.  The DG4-8
  113.           supports sixteen gamma maps, so each channel may use its own unique
  114.           gamma value.
  115.  
  116.           ppppiiiixxxxeeeellllddddeeeepppptttthhhh==== [ DDDDEEEEEEEEPPPPEEEESSSSTTTT | XXXXSSSS | SSSS | MMMM | LLLL | XXXXLLLL ] - Specifies the size
  117.           of the pixels to be used in the combination.  If XXXXSSSS, SSSS, MMMM, LLLL, or XXXXLLLL
  118.           is specified, the combination will only be used with this size
  119.           pixel, and will be invalid if the specified pixel size is not
  120.           available.  If DDDDEEEEEEEEPPPPEEEESSSSTTTT is specified, the largest pixel size which
  121.           can be supported by the hardware configuration will be chosen at the
  122.           time the combination is loaded.  When the combination is validated,
  123.           iiiirrrrccccoooommmmbbbbiiiinnnneeee will report the pixel size which would be chosen for the
  124.           given hardware configuration.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  137.  
  138.  
  139.  
  140.           ssssiiiizzzzeeee====_Xxxxx_Y - Specifies the size of the frame buffer in pixels.  The
  141.           y-size must be a multiple of 2.  The default is either 1280x1024 or
  142.           the minimum legal bounding rectangle of the specified combination,
  143.           whichever is larger.
  144.  
  145.           ssssyyyynnnnccccffffoooorrrrmmmmaaaatttt====<_n_a_m_e> - For external sync, specifies the name of the
  146.           video format file which describes the format to which the video
  147.           subsystem will lock.  If you do not specify an input genlock format,
  148.           the video format of the combination's lowest numbered channel with a
  149.           valid sync signal will be used.
  150.  
  151.           ssssyyyynnnnccccssssoooouuuurrrrcccceeee==== [ IIIINNNNTTTTEEEERRRRNNNNAAAALLLL | EEEEXXXXTTTTEEEERRRRNNNNAAAALLLL | LLLLOOOOOOOOPPPPBBBBAAAACCCCKKKK____CCCCHHHH1111 ] - Specifies
  152.           whether the default genlock source will be internal, external, or
  153.           loopbacked via an external cable from the channel 1 output.
  154.  
  155.           tttteeeexxxxttttppppoooorrrrtttt====<_c_h_a_n_n_e_l _n_u_m_b_e_r> - Specifies the channel to be used as the
  156.           textport output.  This is the channel on which the PROM monitor is
  157.           displayed.  See pppprrrroooommmm((((1111MMMM)))).  This channel must be a valid channel in
  158.           the combination.  By default, the combination's lowest numbered
  159.           channel is used.
  160.  
  161.  
  162.      ----cccchhhhaaaannnnnnnneeeellll <_c_h_a_n_n_e_l> [_p_a_r_a_m_e_t_e_r|_p_a_r_a_m_e_t_e_r=_v_a_l_u_e,...]  - Modifies or queries
  163.      the attributes associated with the specified channel of the video format
  164.      combination.  <_c_h_a_n_n_e_l> may be a number in the range 0-7 to specify the
  165.      corresponding video channel, eeeennnnccccooooddddeeeerrrr to specify the encoder channel,
  166.      ssssiiiirrrriiiiuuuussss to specify the Sirius option board (if it exists), ddddpppplllleeeexxxx to
  167.      specify the dplex board (if it exists), ttttvvvvoooo to specify the tvo board (if
  168.      it exists), hhhhddddggggvvvvoooo to specify the tvo board combined with vbob acting as
  169.      hdgvo (if it exists) ddddvvvvpppp to specify the digital video port board (if it
  170.      exists), or ggggvvvvoooo to specify the 601 serial digital video out board (if it
  171.      exists). The -channel option may be used multiple times on a single
  172.      command line to specify different channels of the video format
  173.      combination.  The assignment of parameters is similar in operation to -b.
  174.      The following parameters may be specified:
  175.  
  176.  
  177.  
  178.           aaaallllpppphhhhaaaa==== [OOOONNNN|OOOOFFFFFFFF] - Specifies that this channel should produce the
  179.           alpha component of the pixels rather than RGB values.  This must be
  180.           used in conjunction with the RGBA10 pixel format, and produces the
  181.           alpha component on the blue component of the output.  When you use
  182.           this option, gamma correction is disabled for the channel.
  183.  
  184.           ccccoooolllloooorrrrssssppppaaaacccceeee====[ RRRREEEECCCC777700009999____11110000 | RRRREEEECCCC777700009999____8888 | CCCCCCCCIIIIRRRR666600001111____11110000 | CCCCCCCCIIIIRRRR666600001111____8888 |
  185.           RRRREEEECCCC222244440000____11110000 | RRRREEEECCCC222244440000____8888 ] - Specifies the colorspace to be output by
  186.           the HDGVO channel. In HDGVO, the RGB pixels from the framebuffer are
  187.           converted into one of 3 colorspaces, at either 8 or 10 bits per
  188.           component. The three colorspaces are REC 709, CCIR601, and REC240.
  189.           The default colorspace is REC 709 at 10 bits per component. This
  190.           setting does not work for channels other than HDGVO.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  203.  
  204.  
  205.  
  206.           ccccuuuurrrrssssoooorrrrpppprrrriiiioooorrrriiiittttyyyy====_v_a_l_u_e - Specifies the priority of this channel for
  207.           cursor drawing.  This priority is used to determine which channel
  208.           displays the cursor in a region in which the input rectangles of two
  209.           or more channels overlap.  Numbers range from 0 to 255, with lower
  210.           numbers indicating higher priority.  If the cursor enters a region
  211.           shared by two channels of equal cursor priority, the channel which
  212.           last displayed the cursor retains it.  If the cursor did not
  213.           previously appear in either of the contending channels, the channel
  214.           with the lower channel number displays the cursor.
  215.  
  216.           ddddeeeelllleeeetttteeee - Specifies that the channel should be deleted from the
  217.           combination.  This parameter does not need to be given an
  218.           assignment.
  219.  
  220.           ddddiiiitttthhhheeeerrrr==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether or not the output of this
  221.           channel is to be dithered.  If ddddiiiitttthhhheeeerrrr is not selected, and the frame
  222.           buffer color representation has more precision than the the video
  223.           format, i.e., 12-bit RGB pixels in the frame buffer with RGB10 pixel
  224.           format for video, the colors will be truncated.  If dither is
  225.           selected, a fixed pattern of noise will be added to the colors
  226.           before they are truncated to reduce the perceptible artifacts
  227.           introduced by truncation.  By default, dithering is OOOOFFFFFFFF.
  228.  
  229.           eeeennnnaaaabbbblllleeee==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether this channel should be enabled
  230.           in the combination.  If a channel is disabled, but not deleted, the
  231.           definition of the channel is stored in the combination, but no
  232.           output is generated, and no bandwidth is consumed for the channel.
  233.           If any parameters are specified for a channel, it is enabled by
  234.           default; all other channels are disabled by default.
  235.  
  236.           ffffiiiilllltttteeeerrrrssssiiiizzzzeeee====_Xxxxx_Y - Specifies the size of the filters used when the
  237.           channel resizes the source pixels to the channel.  Values for the
  238.           x-filter are in the range [1,13], for the y-filter [1,7].
  239.  
  240.           ffffoooorrrrmmmmaaaatttt====<_f_o_r_m_a_t _n_a_m_e> - Specifies the name of the video format to be
  241.           used on this channel.  For the encoder channel, the only valid
  242.           values are NNNNTTTTSSSSCCCC and PPPPAAAALLLL, corresponding to the 640x486_30i and
  243.           768x576_25i formats.  For Sirius, the valid values are 555522225555, 666622225555,
  244.           CCCCCCCCIIIIRRRR666600001111____555522225555, and CCCCCCCCIIIIRRRR666600001111____666622225555, corresponding to the 646x486_30i,
  245.           768x576_25i, CCIR601_525 (720x485_25i), and CCIR601_625
  246.           (720x576_25i) formats, respectively.  For GVO, the valid values are
  247.           CCCCCCCCIIIIRRRR666600001111____555522225555____DDDDGGGGOOOO, and CCCCCCCCIIIIRRRR666600001111____666622225555____DDDDGGGGOOOO.  The default format for the
  248.           encoder is NNNNTTTTSSSSCCCC.  The default for Sirius is 555522225555.  The default for
  249.           GVO is CCCCCCCCIIIIRRRR666600001111____555522225555____DDDDGGGGOOOO.  The default format for all other channels
  250.           is 1280x1024_60.
  251.  
  252.           ggggaaaaiiiinnnn====<_v_a_l_u_e> - Specifies the default output video gain for this
  253.           channel.  The valid range is [0,10], and the default is 1.  This
  254.           value will be coerced to the closest gain which is physically
  255.           realizable on the output channel.  Thus, if the gain is set and
  256.           subsequently queried, the input and returned values may not be the
  257.           same.
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  269.  
  270.  
  271.  
  272.           ggggaaaammmmmmmmaaaa====<_v_a_l_u_e> - Specifies the output video gamma value for this
  273.           channel.  Valid values for gamma are floating point numbers in the
  274.           range [0,20], and the default is 1.7.  Setting this parameter
  275.           modifies the gamma values on all components of the output channel.
  276.           To modify gamma value on a single component, use one of the options
  277.           ggggaaaammmmmmmmaaaarrrr, ggggaaaammmmmmmmaaaagggg, or ggggaaaammmmmmmmaaaabbbb.
  278.  
  279.           hhhhpppphhhhaaaasssseeee====<_v_a_l_u_e> - Specifies the default horizontal phase value for
  280.           this channel.  This setting applies only if the channel is genlocked
  281.           to external sync.  Positive values delay the genlocked video channel
  282.           with respect to external sync, and negative values advance it.
  283.           <_v_a_l_u_e> is a floating point number.  The default is 0000.
  284.  
  285.           mmmmaaaaxxxxssssiiiizzzzeeee====_Wxxxx_H - Specifies the maximum size of the input region of the
  286.           frame buffer.  This places a limit on the bandwidth requirements of
  287.           the channel, and is used in validating the video format combination.
  288.           See also the ssssoooouuuurrrrcccceeeessssiiiizzzzeeee and mmmmiiiinnnnssssiiiizzzzeeee parameters.
  289.  
  290.           mmmmiiiinnnnssssiiiizzzzeeee====_Wxxxx_H - Specifies the minimum size of the input region of the
  291.           frame buffer.  If mmmmiiiinnnnssssiiiizzzzeeee is set equal to mmmmaaaaxxxxssssiiiizzzzeeee, the source
  292.           rectangle cannot be rescaled.  See also the ssssoooouuuurrrrcccceeeessssiiiizzzzeeee and mmmmaaaaxxxxssssiiiizzzzeeee
  293.           parameters.
  294.  
  295.           ppppaaaannnnsssstttteeeepppp====[ LLLLOOOOCCCCKKKKEEEEDDDD | PPPPIIIIXXXXEEEELLLL | TTTTIIIILLLLEEEE ]xxxx[ LLLLOOOOCCCCKKKKEEEEDDDD | PPPPIIIIXXXXEEEELLLL ] - Specifies the
  296.           resolution with which the input window of the channel may be panned
  297.           in x and y while the combination is active.  This parameter does not
  298.           affect the initial placement of the channel's source region.  LLLLOOOOCCCCKKKKEEEEDDDD
  299.           indicates that the source rectangle cannot be be moved in the
  300.           corresponding direction.  PPPPIIIIXXXXEEEELLLL indicates that the window can be
  301.           panned to any pixel location.  TTTTIIIILLLLEEEE for the x resolution indicates
  302.           that the x-coordinate of the window can only be moved in 160 pixel
  303.           increments, corresponding to one frame buffer tile.  This is used to
  304.           decrease the bandwidth requirement of a video format combination.
  305.           Because pixels are fetched from the frame buffer in 160 pixel tiles,
  306.           if the input window is not aligned to these blocks, more pixels may
  307.           need to be fetched that are actually used in the output.  The
  308.           default is TTTTIIIILLLLEEEExxxxPPPPIIIIXXXXEEEELLLL.
  309.  
  310.           ppppeeeeddddeeeessssttttaaaallll==== [OOOOFFFFFFFF|OOOONNNN] - Enables pedestal (also known as setup), an
  311.           artificial black level voltage, for this output.  By default, setup
  312.           is disabled.
  313.  
  314.           ppppiiiixxxxeeeellllffffoooorrrrmmmmaaaatttt====[ RRRRGGGGBBBB11110000 | RRRRGGGGBBBBAAAA11110000 | RRRRGGGGBBBB11112222 | ZZZZ | FFFFSSSS ] - Specifies the
  315.           output pixel format for this channel.  You may specify RRRRGGGGBBBB11110000 to
  316.           indicate 10-bit RGB (no alpha), RRRRGGGGBBBBAAAA11110000 to indicate 10-bit RGB (with
  317.           alpha), RRRRGGGGBBBB11112222 to indicate 12-bit RGB (no alpha), ZZZZ to indicate 24-
  318.           bit Z component, or FFFFSSSS to indicate stereo field sequential.  The
  319.           output pixel format is unrelated to the underlying frame buffer
  320.           organization.  The default is RRRRGGGGBBBB11110000.
  321.  
  322.  
  323.           ssssccccaaaannnn====[ PPPPRRRROOOOGGGGRRRREEEESSSSSSSSIIIIVVVVEEEE | IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD | SSSSTTTTAAAACCCCKKKKEEEEDDDD ] - Specifies the field
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  335.  
  336.  
  337.  
  338.           layout of this channel in the frame buffer.  PPPPRRRROOOOGGGGRRRREEEESSSSSSSSIIIIVVVVEEEE specifies
  339.           sequential data fetching, in which each field draws from the entire
  340.           source region of the channel.  This is the default.  IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD
  341.           specifies an interlaced output format, in which the lines of the
  342.           fields are vertically interleaved in the frame buffer.  SSSSTTTTAAAACCCCKKKKEEEEDDDD
  343.           specifies an interlaced output format, in which the lines of each
  344.           field are contiguous; the lines of the first of _n fields occupy the
  345.           top _nth of the frame buffer, the lines of the second field occupy
  346.           the next _nth, and so on.  The default is either PPPPRRRROOOOGGGGRRRREEEESSSSSSSSIIIIVVVVEEEE or
  347.           IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD, according to the channel's video format.  SSSSTTTTAAAACCCCKKKKEEEEDDDD field
  348.           layout allows you to reduce fill, rendering only the visible lines
  349.           of each field of an interlaced format.
  350.  
  351.           sssscccchhhhpppphhhhaaaasssseeee====<_p_h_a_s_e> - Specifies the subcarrier-to-H phase of the output
  352.           of the channel.  Note this value is useful only on the encoder
  353.           channel.
  354.  
  355.           ssssoooouuuurrrrcccceeeecccchhhhaaaannnnnnnneeeellll====<_c_h_a_n_n_e_l _n_u_m_b_e_r> - Specifies the channel on which the
  356.           current channel is dependent.  If the source channel is the same as
  357.           the current channel, the channel will run in independent mode.  In
  358.           dependent mode, a portion of the visible surface from the source
  359.           channel is sent to this channel for video out.  Only the encoder,
  360.           Sirius, and GVO  channels can operate in dependent mode.  By
  361.           default, this is the same as the channel number.
  362.  
  363.           ssssoooouuuurrrrcccceeeelllloooocccc====_w++++_h - Specifies the default origin of the source rectangle
  364.           of this channel in the frame buffer.  The location is specified in
  365.           pixels, and is relative to the upper-left corner of the screen.  The
  366.           default origin is 0000++++0000.
  367.  
  368.           ssssoooouuuurrrrcccceeeessssiiiizzzzeeee====_Xxxxx_Y - Specifies the default size in pixels of the source
  369.           rectangle of this channel in the frame buffer.  This rectangle may
  370.           be larger or smaller than the video format, but must be within the
  371.           bounds specified by mmmmiiiinnnnssssiiiizzzzeeee and mmmmaaaaxxxxssssiiiizzzzeeee.  This parameter is used for
  372.           resizing pixels from the frame buffer for display.  Setting it
  373.           smaller or larger than the output size of the video format will
  374.           cause the pixels to be magnified or minified.  The default size is
  375.           that of the video format for this channel.
  376.  
  377.           ssssyyyynnnncccc==== [RRRR | GGGG | BBBB | NNNN] - Specifies which of the output components
  378.           have sync enabled.  Use a single letter or a combination of RRRR (red
  379.           component), GGGG (green component), and BBBB (blue component).  NNNN
  380.           specifies sync on none of the components. Default is sync on green
  381.           component.
  382.  
  383.           ssssyyyynnnnccccppppoooorrrrtttt==== [CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTEEEE|HHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL] - Specifies the default setting for
  384.           the output of the alternate sync port.  Specifying CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTEEEE places
  385.           composite sync on the sync port.  Specifying HHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL places
  386.           horizontal sync on the sync port.  The default is CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTEEEE.
  387.  
  388.           ssssyyyynnnnccccttttrrrriiiilllleeeevvvveeeellll==== [OOOONNNN|OOOOFFFFFFFF] - Enables tri-level sync on the RGB outputs.
  389.           The default is OOOOFFFFFFFF.
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  401.  
  402.  
  403.  
  404.           uuuusssseeeeggggaaaammmmmmmmaaaa==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether the gamma values specified
  405.           for this channel should be used in generating the output video.  If
  406.           uuuusssseeeeggggaaaammmmmmmmaaaa is OOOOFFFFFFFF, the default gamma value will be used instead.  The
  407.           gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa global parameter overrides this option.
  408.  
  409.           vvvvpppphhhhaaaasssseeee====<_v_a_l_u_e> - Specifies the default vertical phase value for this
  410.           channel.  This setting applies only if the channel is genlocked to
  411.           external sync.  vvvvpppphhhhaaaasssseeee ranges from 0 to the number of lines in the
  412.           video format minus one.  The default value is 0.
  413.  
  414.      Other options available with ircombine:
  415.  
  416.  
  417.      ----ddddeeeessssccccrrrriiiippppttttiiiioooonnnn<_d_e_s_c_r_i_p_t_i_o_n> Specifies a string of up to 256 characters
  418.      which describes the combination.  If <_d_e_s_c_r_i_p_t_i_o_n> contains any spaces,
  419.      it should be enclosed in quotes.  If the combination is written to a
  420.      file, this string is included in the file; otherwise it has no effect.
  421.  
  422.  
  423.      ----iiiinnnnppppuuuuttttffffiiiilllleeee<_f_i_l_e_n_a_m_e> - After command line options are exhausted, read
  424.      additional input from _f_i_l_e_n_a_m_e.  This file utilizes the same syntax as
  425.      the command line, except that it may contain carriage returns between
  426.      options or parameters.
  427.  
  428.  
  429.      ----pppprrrriiiinnnnttttccccoooommmmmmmmaaaannnndddd - Generates a command line which would create the ssssoooouuuurrrrcccceeee
  430.      combination.  This command line is printed to stdout.  If the ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn
  431.      option is specified, it will be reproduced on the generated command line.
  432.  
  433.      ----ttttaaaarrrrggggeeeetttt<_d_i_s_p_l_a_y_n_a_m_e> - Specifies that the graphics system whose video
  434.      format combination will be changed is a display other that specified by
  435.      the DISPLAY environment variable.  This option uses the same format as
  436.      the -display toolkit option.  Note that the -display option does not
  437.      change the target display.  The -target option may also be used to
  438.      specify the pipe for which the combination is to be changed on systems
  439.      with multiple graphics pipes.  If the pipe number is not specified with
  440.      this command line option, the pipe number is extracted from the DISPLAY
  441.      environment variable.
  442.  
  443.      ----vvvvaaaalllliiiiddddaaaatttteeee[_p_a_r_a_m_e_t_e_r=_v_a_l_u_e,...]  - Specifies the hardware configuration
  444.      for which to validate that the video format combination can be supported.
  445.      Any parameter which is not specified by this option defaults to the
  446.      configuration of the target display, if it has _I_n_f_i_n_i_t_e_R_e_a_l_i_t_y graphics.
  447.      Otherwise, the defaults given below are used.  The following parameters
  448.      may be specified with this option:
  449.  
  450.  
  451.           nnnnuuuummmmrrrrmmmmssss====<_c_o_u_n_t> - Specifies the number of raster managers available.
  452.           The default is 1111.
  453.  
  454.           ggggffffxxxxrrrreeeevvvv====<_r_e_v_i_s_i_o_n> - Specifies the version of graphics hardware.
  455.           Valid types are OOOONNNNYYYYXXXX____IIIIRRRR ,,,, OOOONNNNYYYYXXXX2222____IIIIRRRR ,,,, and OOOONNNNYYYYXXXX2222____RRRR.  The default is
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  467.  
  468.  
  469.  
  470.           OOOONNNNYYYYXXXX____IIIIRRRR.
  471.  
  472.           nnnnuuuummmmcccchhhhaaaannnnnnnneeeellllssss====<_c_o_u_n_t> - Specifies the number of video channels
  473.           available.  The default is 2222.
  474.  
  475.           cccchhhhaaaannnnnnnneeeellllrrrreeeevvvv====<_r_e_v_i_s_i_o_n> - Specifies the revision number of the video
  476.           channels.  The default is 0000.
  477.  
  478.           ooooppppttttcccchhhhaaaannnnnnnneeeellllttttyyyyppppeeee====<_t_y_p_e> - Specifies the type of the option channel.
  479.           Valid types are NNNNOOOONNNNEEEE ,,,, SSSSIIIIRRRRIIIIUUUUSSSS, GGGGVVVVOOOO, DDDDPPPPLLLLEEEEXXXX, and DDDDVVVVPPPP.  The default is
  480.           NNNNOOOONNNNEEEE.
  481.  
  482.  
  483.      ----vvvveeeerrrrbbbboooosssseeee - Enables verbose mode.  This causes a listing of the entire
  484.      video format combination to be printed to stdout.
  485.  
  486.  
  487. SSSSTTTTAAAATTTTUUUUSSSS
  488.      On completion, ircombine returns a 0 if the combination was successfully
  489.      created.  If ircombine was unsuccessful, it returns a non-zero value.
  490.  
  491.  
  492. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  493.      ircombine -destination file 1280x1024_60.cmb \
  494.           -channel 0 format=1280x1024_60.vfo
  495.  
  496.  
  497.           Creates a combination file _1_2_8_0_x_1_0_2_4__6_0._c_m_b with a single channel
  498.           whose format is 1280x1024_60.
  499.  
  500.  
  501.      ircombine -destination active \
  502.           -source file 1280x1024_60.cmb \
  503.           -channel 0 gain = 2
  504.  
  505.  
  506.           Loads the combination stored in _1_2_8_0_x_1_0_2_4__6_0._c_m_b as the current
  507.           combination, and changes channel 0's gain to 2.
  508.  
  509.  
  510.      ircombine -destination file 640x486_30i.cmb \
  511.           -global size=640x486 \
  512.           -channel 0 format=640x486_30i.cmb, scan=INTERLEAVED
  513.  
  514.  
  515.           Creates a combination file _6_4_0_x_4_8_6__3_0_i._c_m_b with a managed area of
  516.           640x486 pixels, a single channel with a 30Hz interleaved format,
  517.           640x486_30i, and whose field layout is IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD.
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  533.  
  534.  
  535.  
  536.      ircombine -destination eeprom \
  537.           -global size=640x480 \
  538.           -channel 0 format=640x480_120s.vfo
  539.  
  540.  
  541.           Stores a combination in the eeprom with a managed area of 640x480
  542.           pixels, and a single channel with a 120Hz stereo format,
  543.           640x480_120s.
  544.  
  545.  
  546.      ircombine -destination file 2@1280x1024_72.cmb \
  547.           -channel 0 format=1280x1024_72.vfo, sourceloc=0+0,
  548.           panstep=LOCKEDxLOCKED \
  549.           -channel 1 format=1280x1024_72.vfo, sourceloc=1280+0,
  550.           panstep=LOCKEDxLOCKED
  551.  
  552.  
  553.           Creates a combination file _2@_1_2_8_0_x_1_0_2_4__7_2._c_m_b with two channels
  554.           whose formats are both 80x1024_72, and whose source regions are
  555.           located side by side in the frame buffer, with their locations
  556.           fixed.
  557.  
  558.  
  559. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  560.      setmon(1G), Xvc(3).
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.